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Playback 3: Error handling 
and deployment 


© Copyright IBM Corporation 2018 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


© Copyright IBM Corporation 2019 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


ZB828 Unit 9 Transcript 


Slide 2 


Unit objectives 


° Describe how to handle errors in a process or service 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


This unit concentrates on hardening your process. Building in robust error handling is necessary, 
and developers must learn to expect the unexpected. Now is the chance to ask, “How do you 
handle things if the process does not run as expected?” There is also a hands-on lab exercise 
available to reinforce the concepts that are presented in this unit. 


After completing this unit, you should be able to: 
e Describe how to handle errors in a process or service 
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Playback 3: Hardening processes and services 


° Playback 3 is the final Playback 


° The goal of this Playback is to 
demonstrate what happens 
when your process encounters 
an error, and to demonstrate 
how that error is handled 


Consider demonstrating 
the different error handling 
patterns that are used in 
your process application 


Conveys the general 
principles that are used for 
error handling without having 
to demonstrate every instance 
of error handling in your 
process app 


on! reMen, 

eae) 
Playback 

[ 34 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


Playback 3 is the final Playback for the project. The goal is to demonstrate what happens when 
your process encounters an error, and to demonstrate how the process handles this error. 


Consider demonstrating the different error handling patterns that are used in your process 
application so stakeholders have a good idea of the general way errors are handled when they 
occur. Using test harnesses and services to generate errors presents real-world scenarios for the 
presentation. 
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Topics 


* Handling errors in a process 
° Handling errors in services 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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Key concepts in this unit 


¢ Playback 3: Hardening processes and services: This stage of the 
Playback demonstrates what happens when your process encounters 
an error, and how that error is handled 


¢ Error handling in process: Attach an error intermediate event to an 
activity and connect that event to an error handling flow or activity 


¢ Error handling in services: Use error intermediate events to catch 
errors, and use error end events to throw errors 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


A list of the key concepts in this unit is shown. 
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Handling errors in a process 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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Using error events to handle errors 


e When you develop an application in IBM Business Automation 
Workflow, build error handling into processes and services as follows: 


= To detect errors 
= To specify how errors are thrown and caught in your runtime environment 
= To recover in a predictable manner 
° Three types of error events are possible: 
= Error end events in processes and services that throw errors 
= Error intermediate events in processes and services that catch errors 
= Error start events in process event subprocesses that catch errors 


e Assign error codes and error data to thrown errors from the error end 
events 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


When you develop an application in IBM Business Automation Workflow, you build error handling 
into processes and services to detect errors, to specify how errors are thrown and caught in your 
runtime environment and to recover in a predictable manner. 


Three types of error events are possible: 

Error end events in processes and services that throw errors 

Error intermediate events in processes and services that catch errors 
Error start events in process event subprocesses that catch errors 


You assign error codes and error data to thrown errors from the error end events 
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Handling errors in a process 


° Catching errors with error intermediate events: For processes, 
you can attach an error intermediate event to an activity and connect 
that event to an error handling flow or activity. 


° Throwing errors: You can use an error end event in your process to 
specify an error code and map to an error type on errors that are 
thrown from the flow of a process or a service. 


Process events Description 


Error intermediate event at the »° Catches specified errors or all 
boundary of an activity errors 
¢ Provides error handling logic for 
errors that the attached activity 
raises 


) Error end event e Use to throw an error to parent 
processes 
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The following considerations apply when you handle errors in a process: 
Considerations 1 
*Catching errors with error intermediate events 

For processes, you can attach an error intermediate event to an activity and connect that 

event to an error handling flow or activity. 

To determine whether to use error intermediate events, consider the following points: 

-If an error occurs while a process is running an activity with an attached error event at the 
boundary, the process flows along the sequence line that is attached to the error event. Errors 
are handled in the flow and then proceed with the normal processing. 

-Error intermediate events must be attached to an activity. 

-You can have multiple error events for an activity, but only one catches the error. 

-Consider specifying the error data to catch specific errors, filtering on the error code for the types 
of errors that are caught, and mapping to a variable after the errors are caught. When all errors 
are caught, or if only an error code is specified, the error data is captured in an XMLElement 
-Considerations 2 

*Catching errors with error event subprocesses 

An event subprocess is a specialized type of subprocess that is not part of the normal 

sequence flow of its parent process. An error event subprocess is an event subprocess that 

contains an error start event. The event subprocess does not connect with sequence flow 
and runs only when the start event inside the event subprocess is triggered. You can use 
error event subprocesses to handle errors in your process. 

To determine whether to use error event subprocesses, consider the following points: 
-Define a readable process by locating the error event inside the event subprocess instead of 
defining it in the process. 

-To reuse the error-handling flow for multiple tasks in your process, use event subprocesses. To 
reuse an error-handling flow with attached events, you must attach an intermediate event for 
each of the tasks and then connect those events to the error-handling flow. 

-Define data objects that you can access only from within the event subprocess. You can define 
only those data objects that belong to a subprocess. The parent process is not cluttered with 
unnecessary variables. 

Considerations 3 


eThrowing errors 
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You can use an error end event in your process to specify an error code and map to an error 
type on errors that are thrown from the flow of a process or a service. 

When working with either error events or event subprocesses, think about whether errors 
can be handled immediately, and normal processing can continue, or if another error can be 
thrown at another level. Then, implement error handling from the bottom up. In other cases, 
it might be more efficient and readable if a subprocess can be reused. Build each linked 
process and service so that errors can be captured and corrected. If a correction is not 
possible at the lowest level of the implementation, you can allow the error to move up a 
level. Do not include an error event to rethrow the error to the calling service or process, as 
shown in the following section. 
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Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


wo 


Use error events to specify how errors are thrown and caught in your runtime environment. 

You can assign error codes to errors that the error end event throws. 

Errors are caught in the following order in your runtime environment: 

e The boundary events catch errors that the attached activity raises. 

e Errors are caught in the error event subprocesses if the subprocess is in a process or in an 
unattached intermediate error event in a service 

e Errors are propagated to the next level. 
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Handling errors in services 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


Topic 2: Handling errors in services. 
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Handling errors in a process 


° Catching errors with error intermediate events: For processes, 
you can attach an error intermediate event to an activity and connect 
that event to an error handling flow or activity. 


° Throwing errors: You can use an error end event in your process to 
specify an error code and map to an error type on errors that are 
thrown from the flow of a process or a service. 


Process events Description 


Error intermediate event at the »° Catches specified errors or all 
boundary of an activity errors 
¢ Provides error handling logic for 
errors that the attached activity 
raises 


) Error end event e Use to throw an error to parent 
processes 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


Notes: 
The following considerations apply when you handle errors in a process: 


¢ Catching errors with error intermediate events 
For processes, you can attach an error intermediate event to an activity and connect that 
event to an error handling flow or activity. 
To determine whether to use error immediate events, consider the following points: 
- If an error occurs while a process is running an activity with an attached error event at 
the boundary, the process flows along the sequence line that is attached to the error 
event. Errors are handled in the flow and then proceed with the normal processing. 


- Error intermediate events must be attached to an activity. 
- You can have multiple error events for an activity, but only one catches the error. 


- Consider specifying the error data to catch specific errors, filtering on the error code for 
the types of errors that are caught, and mapping to a variable after the errors are caught. 
When all errors are caught, or if only an error code is specified, the error data is 
captured in an XMLElement in the tw.system.step.error variable. 

¢ Throwing errors 

You can use an error end event in your process to specify an error code and map to an error 

type on errors that are thrown from the flow of a process or a service. 

When working with either error events or event subprocesses, think about whether errors 

can be handled immediately, and normal processing can continue, or if another error can be 

thrown at another level. Then, implement error handling from the bottom up. In other cases, 
it might be more efficient and readable if a subprocess can be reused. Build each linked 
process and service so that errors can be captured and corrected. If a correction is not 

possible at the lowest level of the implementation, you can allow the error to move up a 

level. Do not include an error event to rethrow the error to the calling service or process, as 

shown in the following section. 


12 


© Copyright IBM Corporation 2019 
Course materials may not be reproduced in whole or in part without the prior written permission of IBM. 


ZB828 Unit 9 Transcript 


Slide 12 


Catching errors in services 


Service component Description 


Error intermediate ¢ Listens for exceptions from the service 
event that is component to which it is attached 
attached to the 
boundary of a step 


Error intermediate ¢ Errors in the steps of the service flow and 
event as part of the errors that are missed in the error 
service flow intermediate event that is attached to an 


activity are caught 
¢ This event can have only outbound links 


C) Throw exception ¢ Use to purposely throw an error and end 
processing 
¢ You might, for example, use a Throw 
Exception component if you return too 
many rows from a database (over a limit 
that is normal and would bog down the 
server) 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


Similar to processes, for services, you can use error intermediate events to catch errors, and you 
can use error end events to throw errors. Attach error intermediate events to steps in your service 
to catch errors in that step. You can also include error intermediate events to act as global error 
handlers in the service flow. 


Determine whether errors can be handled immediately, and normal processing can continue, or if 
another error can be thrown at another level. Then, implement error handling from the bottom up. 


Use an error end event to throw a specific error and specify error codes and error data for the 
error. 


Consider specifying the error data to catch specific errors. For example, you might filter on the 
error code for the types of errors that are caught. Then, map the error code to a variable after the 
errors are caught. When all errors are caught, or if only an error code is specified, the error data 
is captured in an XMLElement in the tw.system.error variable. 


Be sure to include the appropriate logic and an error end event in your service. Throw errors 


when they still exist after attempts to handle them. Throwing the errors ensures that the errors are 
passed to parent processes and services and can be handled at a higher level. 
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Client-side human services: Throwing errors by using error 
end events (1 of 2) 


° For errors that are thrown from the flow of a client-side human service, 
use error end events to end the processing of a service flow at a 
specified step 


° To throw a specific error, do the following steps: 


= Set the properties of the error in the Implementation tab of the error end 
event 


= Specify the error code and map the error data to a specified variable 


Playback 3: Error handling and deployment 
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For errors that are thrown from the flow of a client-side human service, use error end events to 
end the processing of a service flow at a specified step. To throw a specific error, do the following 
steps: 

« Set the properties of the error in the Implementation tab of the error end event 

« Specify the error code and map the error data to a specified variable 
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Client-side human services: Throwing errors by using error 
end events (2 of 2) 
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This implementation is an example of using error end events in a client-side human service. 


In the diagram, connect each error end event to the logic that you want to run when the error 
occurs. If you have multiple error end events, connect each one to the error handling logic 
that applies. The following example shows a client-side human service that uses a coach to 
display an error message to the user. The coach uses a variable validation script, which is 
connected to two different error end events with an exclusive gateway. 
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Playback 3: Hardening processes and services 


° You arrived at the final Playback 


° The goal of this Playback is to 
demonstrate what happens 
when your process 


Consider demonstrating 
the different error handling 
patterns that are used in 


encounters an error, and ee" 
your process application 
Conveys the general 
principles that are used for 
error handling without having 
to demonstrate every instance 

of error handling in your process 


to demonstrate how that | 
Playback 
r 3 = 
application 


error is handled 
Playback 3: Error handling and deployment © Copyright IBM Corporation 2018 


You arrived at the final Playback. The goal is to demonstrate what happens when your process 
encounters an error, and to demonstrate how that error is handled. Demonstrate an example of 
all the error handling you built for your process. All stakeholders must be satisfied that the 
process handles errors appropriately and addresses the errors that they might anticipate. 
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Unit summary 


* Describe how to handle errors in a process or service 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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Review questions 


1. When an error occurs in an activity in a process, which takes the 
highest precedence in catching the error? 
A. An event subprocess in the same process as the activity 
B. A flow that is exiting the activity and going to an error end event 
C. An attached error intermediate event 


2. What are the types of error events that can be modeled in services? 
A. Error message event 
B. Error intermediate event 
C. Error end event 
D. Error start event 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 


Notes: 
Write your answers here: 
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Review answers 


1. C. Boundary events take first precedence. 


2. Error intermediate event and error end event. 
The error intermediate event can be attached to a step or can be 
placed on the palette to catch errors globally inside the service. 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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Exercise 9 


Playback 3: Handling errors and deploying 
your process application 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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Exercise objectives 


After completing this exercise, you should be able to: 
° Harden a service with a catch exception component 
° Create a snapshot for deployment 


Playback 3: Error handling and deployment © Copyright 18M Corporation 2018 
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